home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / Multiprocessing SDK / Sample Code / PowerFrax / PowerFrax 1.4.2 Read Me < prev    next >
Encoding:
Text File  |  1996-04-16  |  5.5 KB  |  154 lines  |  [ttro/ttxt]
  1.                                                                                                                                                                                                                      4/16/96
  2.  
  3.  
  4.  
  5. PowerFrax
  6.  
  7. PowerFrax is a benchmarking application that generates fractals from the classic Mandelbrot Set. The fractal patterns that are shown on the screen are the result of intense floating point calculations performed for each pixel in the image. The length of time required to perform these calculations is a good measure of the capabilities of the processor or processors performing them. PowerFrax has a built-in timer that allows comparisons to be easily made.
  8.  
  9.  
  10. Using PowerFrax
  11.  
  12. PowerFrax has a number of features that make exploring the Mandelbrot Set easy and fun.
  13.  
  14. When you first launch PowerFrax it will open a new window and display the Mandelbrot Set. Click and drag out a selection within the fractal to create a new fractal zoomed in on the area selected. This is the principle way to explore the fractal. To make a square selection hold down the shift key.
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.     
  32.                                                             Fig.1 The area selected is magnified into a new window
  33.  
  34. Clicking and dragging will work in any fractal window.
  35.  
  36.  
  37. The PowerFrax Menus
  38.  
  39. This section describes the options available in the PowerFrax menus.
  40.  
  41. The File Menu
  42.  
  43. New
  44.     Creates a new Mandelbrot Set.
  45. Open…
  46.     Opens a previously saved fractal.
  47. Cycle…
  48.     All previously saved fractals in the selected folder will be played back repeatedly until 'Stop Cycling' is selected from the File menu.
  49. Close
  50.     Closes the current fractal. Hold down the option key to close all the fractals.
  51. Save
  52.     Saves the current fractal. Note that PowerFrax does not prompt the user to save changed fractals so be sure to save fractals that you like before closing them or quitting PowerFrax.
  53. Save As…
  54.     Same as save except that the user will be prompted to name the fractal.
  55. Page Setup…
  56.     Sets up printing parameters using the standard Page Setup dialog.
  57. Print
  58.     Prints the current fractal.
  59. Quit
  60.     Quits PowerFrax.
  61.  
  62. The Edit Menu
  63.  
  64. Copy
  65.     Copies the current fractal to the clipboard.
  66. Default Fractal…
  67.     Changes the fractal that will be generated when 'New' is selected. This option can also be used to restore the original default fractal.
  68.  
  69. The Control Menu
  70.  
  71. Restart
  72.     Restarts the current fractal from the beginning.
  73. Repeat
  74.     Restarts the current fractal from the beginning. Each time it finishes it will be restarted again after a one second delay.
  75. Exact Colors
  76.     Uses the precise color set associated with the fractal. This option is not needed and is not available when the monitor is in millions of color mode. When this option is used, colors in windows other than the current fractal window may not appear correctly. Monitors with at least 256 colors capability are required for this option to work well.
  77. Animate Colors
  78.     Centers the current fractal on the monitor, grays out the rest of the screen then cycles through all the available colors in the color set associated with the fractal. Use the command key to reverse the direction of the animation. The option key freezes the animation temporarily. The shift key will slow the animation down. Click the mouse or push any other key to end the animation. Note that on multiple monitor systems the fractal will not be centered.
  79.  
  80. The Window Menu
  81.  
  82. Hide Info
  83.     Hides the information window.
  84. Window Name
  85.     Selects the named window.
  86.  
  87. The Multiprocessing Menu
  88.  
  89. Use 'n' Processors
  90.     Selects the number of processors to be used to regenerate all open fractals and to generate all subsequent fractals.    This menu is only available on multiprocessing systems.
  91.  
  92.  
  93. The PowerFrax Info Window
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                                                                                             Fig. 2 The PowerFrax Info Window
  118.  
  119. The PowerFrax Info window describes the current fractal. All the fields in the Info window can be edited.
  120.  
  121. The first four fields are described in the Mandelbrot Set discussion below.
  122.  
  123. The Size fields are the the pixel dimensions of the current fractal. Editing these two fields is the only way to make the fractal bigger or smaller.
  124.  
  125. The Colors menu allows the user to recolor the current fractal with any one of a variety of different color sets.
  126.  
  127. The Generation Time display shows how long it took to calculate the current fractal. Only the time required to perform the calculations is measured -nothing else.
  128.  
  129. The Cursor display shows the position in the complex plane of the pixel under the cursor. If the cursor is not over a fractal then this display will be blank.
  130.  
  131.  
  132. The Mandelbrot Set
  133.  
  134. The Mandelbrot Set is named after Benoit Mandelbrot, a mathematician who did considerable research into fractal systems. It is based on the iterative application of the function f(z) = z*z + c, where z is the result of the previous application and c is a constant point in the complex plane.
  135.  
  136. To generate a fractal the function f(z) is applied iteratively for each pixel in the image. For each pixel the initial value of z is set to 0 and the value of c is set to the pixel's corresponding point in the complex plane.  The function f(z) is applied repeatedly until the magnitude of f(z) exceeds the escape radius or until the number of iterations equals 255. The number of iterations performed determines the color of the pixel.
  137.  
  138. In PowerFrax's Info window the Center fields are the center of the current fractal in the complex plane.
  139.  
  140. The Step field is the degree of seperation of each pixel from its immediate neighbors in the complex plane.
  141.  
  142. The Escape Radius field is used to determine when to stop performing iterations.
  143.  
  144.  
  145. Changes Since 1.4.0
  146.  
  147. Added 'Default Fractal…' menu item.
  148.  
  149. Fixed multiple printing related problems.
  150.  
  151. File opening and saving will no longer crash if QuickTime is not present.
  152.  
  153. Fixed blank info. window problems when multiple monitors are present.
  154.